home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / DTP / CLEANTXT.SPK / !CleanTXT / !Help < prev    next >
Text File  |  1997-08-20  |  4KB  |  82 lines
  1.                                    !CleanTXT
  2.  
  3.                            Version 0.02ß (20 August 1997)
  4.  
  5.                                Needs RISC OS 3.50
  6.  
  7. !CleanTXT is intended to process text files to make them suitable for import
  8. into word processors.
  9.  
  10. In its current version, !CleanTXT first removes stray spaces from the beginnings
  11. and ends of lines.  It then converts pairs of <new line> characters into single
  12. a <new line> character and converts single <new line> characters into spaces.
  13.  
  14. To use, drop a text file onto the icon.  The control window will open.  This
  15. allows additional identifiers for paragraph ends to be setup:
  16.  
  17. •  Lines indented with at least a  specified number of spaces will be treated
  18.    as new paragraphs.  This can be useful for identifying "letter style"
  19.    paragraphs, lists, tables, program listings etc.
  20. •  Lines starting with a tab can be treated as the beginning of a new
  21.    paragraph.  This can be useful in the same circumstances as above.
  22. •  Lines starting with a digit can be treated as the beginning of a new
  23.    paragraph.  This can be useful where there are paragraph numbers or
  24.    enumerated lists.
  25. •  There is a free form input for characters at the beginning of lines (ignoring
  26.    initial spaces) that should be treated as commencing a new paragraph.  This
  27.    can be useful for identifying bulleted lists.  By default this looks for
  28.    bullet points (•), asterisks (*) or dashes (-).
  29. •  There is a free form input for characters at the end of lines (ignoring
  30.    trailing spaces) that should be treated as ending a paragraph.  This can be
  31.    useful where there is no easy identifier of paragraph ends and fulls stops at
  32.    the end of sentences or colons introducing lists must be used.
  33.  
  34. This program has not been through extensive bug testing and so may have
  35. problems or bugs.  I should appreciate it if any bugs or additions to the
  36. wishlist could be emailed to me.
  37.  
  38. Email:
  39.  
  40. alec.crawford@argonet.co.uk
  41.  
  42. Wish list:
  43.  
  44. •  Intelligent recognition and formatting of tables (more tricky to implement
  45.    and so unlikely to be in the next version).  In the short term, this will
  46.    be handled by converting a specified number of spaces (or more) into a
  47.    tab character.
  48.  
  49. •  Recognition of headings as single lines or lines with "====" or "---"
  50.    underlining.  The output could be either in the form of RTF of Impression
  51.    DDF formats.
  52.  
  53. •  Improved speed.  Currently !CleanTXT is not efficiently programmed.  In the
  54.    short term, speed may be controllable by adjusting (as an option) how
  55.    frequently !CleanTXT polls.  In addition, it may be helpful to remove some
  56.    of the reporting functions from the processing window - let me know if this
  57.    would be helpful (I am testing this on a StrongARM).
  58.  
  59. •  Backward compatability.  This version requires RISC OS 3.5 (at least) because
  60.    it uses "OS_DynamicArea" to allocate itself memory.  If there is demand, I
  61.    can easily produce a version that predefines space in the program area (and
  62.    hence will be useable in RISC OS 3.00 or greater - I believe that Dr Wimp
  63.    requires at least RISC OS 3.00) or, if a better programmer (or with more
  64.    time to peruse the manuals) wishes to suggest a flexible memory allocation
  65.    system from BASIC for earlier OS, I may be able to look into it.
  66.  
  67. Known bugs:
  68.  
  69. •  !CleanTXT occasionally tags one or two stray characters to the end of the
  70.    text
  71.  
  72. Credits:
  73.  
  74. Many thanks to Andrew Ayre for Dr Wimp (3.01) without which this program would
  75. not have been programmed.  With Dr Wimp, programming was a matter of a few
  76. hours.  Thoroughly recommended!
  77.  
  78. History:
  79.  
  80. 0.01  Version not distributed
  81.  
  82.